home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 2002 November / SGI Freeware 2002 November - Disc 1.iso / dist / fw_exmh.idb / usr / freeware / catman / u_man / cat1 / exmh.Z / exmh
Text File  |  2002-07-08  |  42KB  |  799 lines

  1. EXMH TOUR(1)          INTRO    TO EXMH             EXMH TOUR(1)
  2.  
  3.  
  4.  
  5. NNAAMMEE
  6.        exmh - An introduction to the exmh mail user interface.
  7.  
  8. IINNTTRROODDUUCCTTIIOONN
  9.        This  man  page    provides a quick tour through some of the
  10.        basic features of  _e_x_m_h    _v_e_r_s_i_o_n     _2_._0_,  which  provides    a
  11.        graphical user interface    to the MH mail system.
  12.  
  13.        After  you  read     this  tutorial    you should be able to use
  14.        _e_x_m_h for    your basic daily mail reading  needs.    You  will
  15.        learn how to send mail, read mail, manage your messages in
  16.        folders,    and adjust some    of the _e_x_m_h features by    means  of
  17.        its Preferences user interface.
  18.  
  19.        There is    much more documentation    available on-line through
  20.        HTML pages that are viewable from within    exmh.  In partic
  21.        ular.   eexxmmhh--uussee    provides information about using the more
  22.        advanced    features of _e_x_m_h.  If you are already an  experi
  23.        enced  email  user,  you    may want to just read the GETTING
  24.        STARTED section here and    then skip  to  the  eexxmmhh--uussee  man
  25.        page.  eexxmmhh--ccuussttoomm describes how    to customize exmh to suit
  26.        your needs.  eexxmmhh--rreeff lists each    button and menu    entry  in
  27.        _e_x_m_h and    explains what they do.    If you are an experienced
  28.        _e_x_m_h user, this may be the most useful man page for you.
  29.  
  30.        A cleaned up version of these man pages appear in the  3rd
  31.        edition    of  the     book  by Jerry    Peek, _M_H _& _x_m_h_:    _e_m_a_i_l _f_o_r
  32.        _u_s_e_r_s _a_n_d _p_r_o_g_r_a_m_m_e_r_s, which is published  by  O'Reilly    &
  33.        Associates.
  34.  
  35.        Web versions of the documentation can also be found at
  36.  
  37.        http://www.beedub.com/exmh/
  38.  
  39.  
  40. GGEETTTTIINNGG    SSTTAARRTTEEDD
  41.        If  you    are already an MH or _x_m_h user, you can start with
  42.        the examples given in this tour.     If you    are a  new  user,
  43.        exmh will set up    your basic MH environment.  This includes
  44.        a Mail directory    which will have    one subdirectory for each
  45.        mail  folder, plus several files    that MH    mail uses for its
  46.        own purposes.  You also get a ~/.mh_profile file    that  has
  47.        user settings for MH and    exmh.
  48.  
  49.        _E_x_m_h  uses the regular MH programs to manipulate    your mail
  50.        folders and messages.  This means it  is     compatible  with
  51.        command-line use    of MH programs,    and its    actions    should be
  52.        familar if you are an experienced MH user.  If you  are    a
  53.        new  MH    user,  then the    details    of running MH programs is
  54.        hidden behind the graphical interface.    The  MH     programs
  55.        used  by     exmh  are  described towards the end of this man
  56.        page.
  57.  
  58.        When you    run _e_x_m_h for the  first     time  it  checks  a  few
  59.        things  in  your    MH profile.  In    particular, it depends on
  60.        the Draft-Folder    and Unseen-Sequence  profile  components.
  61.        If  these  profile  components  are  not    present, a dialog
  62.        appears and _e_x_m_h    can set    them up    for you.  If you  do  not
  63.        let  _e_x_m_h  create  them nor set them up by hand,    _e_x_m_h will
  64.        not work    properly.  These profile entries are described in
  65.        the eexxmmhh--rreeff man    page.
  66.  
  67.        _E_x_m_h  has  been    designed to be very flexible, although it
  68.        will work just fine "out     of  the  box".      The  Preference
  69.        package    used  to  adjust  some of the settings in exmh is
  70.        introduced in this man page, and     some  of  the    important
  71.        settings     are  described     here.     A more    complete guide to
  72.        customizing _e_x_m_h    is given in the    eexxmmhh--ccuussttoomm man    page.
  73.  
  74. RRUUNNNNIINNGG    EEXXMMHH
  75.        The command to start _e_x_m_h looks like this:
  76.  
  77.           exmh -display _h_o_s_t_n_a_m_e:0 &
  78.        If your DISPLAY environment variable is set  up    properly,
  79.        then  the -display argument is not needed, and the command
  80.        is even simpler.     You do    not need to specify  a    -geometry
  81.        argument,  although  _e_x_m_h  supports  one.  Instead, simply
  82.        position    and size the window using  your     window     manager.
  83.        When  _e_x_m_h quits, it saves the geometry information so you
  84.        don't have to worry about it.  It does this with     all  its
  85.        top  level  windows, so you can adjust their position once
  86.        and then    forget about it.  There     are  more  command  line
  87.        options described in the    eexxmmhh--rreeff man page.
  88.  
  89.        You can add the exmh command to your startup X environment
  90.        by editting your    startup    file (like .xsession).    You might
  91.        also  want  to add it to    the main menu of your window man
  92.        ager.  The details about    this vary from X system    to X sys
  93.        tem,  so     ask  your local X guru    for help.  _E_x_m_h    also sup
  94.        ports the window    manager     session  protocol,  which  means
  95.        that  session-smart  window  managers  will  automatically
  96.        start exmh for you if you quit X    when _e_x_m_h is running.
  97.  
  98. TTHHEE EEXXMMHH DDIISSPPLLAAYY
  99.        This section describes the main parts of    the _e_x_m_h display.
  100.        It  probably  makes sense to run    exmh at    this point so you
  101.        can follow along.  There    are three sets of buttons in  the
  102.        interface, and three main subwindows.
  103.  
  104.        MMaaiinn  BBuuttttoonnss.    Along  the  top    of the window is a set of
  105.        buttons and menus that apply to _e_x_m_h  itself.   Quit,  for
  106.        example,     quits _e_x_m_h.  The Help button pops up a    menu, and
  107.        you can select the  entries  there  to  get  more  on-line
  108.        information  about  _e_x_m_h.   Use    the  left mouse    button to
  109.        select the buttons and menus.  A    button    will  change  its
  110.        appearence  when    you press it, and it will be invoked when
  111.        you release the mouse over the button.  If you  slide  the
  112.        mouse off the button before releasing it, nothing happens.
  113.  
  114.        FFoollddeerr DDiissppllaayy.    Below the main buttons is the folder dis
  115.        play  subwindow.     It has    a special button for each of your
  116.        top-level folders, and these are    called _f_o_l_d_e_r _l_a_b_e_l_s.  As
  117.        a  new  user you    will see two folder labels, one    for inbox
  118.        and drafts.  The    inbox folder is    for  your  new    messages,
  119.        and the drafts folder is    for messages you are writing.  If
  120.        you have    used MH    (or xmh) before, then you may  have  many
  121.        more  folders that will appear in this display.    The mouse
  122.        bindings    for folder labels are explained    in  the     eexxmmhh--uussee
  123.        man  page.  The _C_o_l_o_r _L_e_g_e_n_d from the Help menu also tells
  124.        you how the folder labels respond to mouse clicks.
  125.  
  126.        FFoollddeerr CCaacchhee.  A    second folder display called  the  _f_o_l_d_e_r
  127.        _c_a_c_h_e  may  appear  under  the  main folder display.  This
  128.        shows the folder    labels for recently used folders.  If you
  129.        only  have  a  few folders this wastes screen real estate.
  130.        The PREFERENCES section near the     end  of  this    man  page
  131.        explains    how to turn this off via the Folder Cache prefer
  132.        ences setting.  If you are a first-time    exmh  user,  Exmh
  133.        tries  to guess if you need this    display    based on the num
  134.        ber of folders and nested folders you have.
  135.  
  136.        FFoollddeerr BBuuttttoonnss.    The middle set of buttons is  for  opera
  137.        tions  that apply to folders.  For example, you can create
  138.        a new folder with the New button    here.  The More... button
  139.        displays    a popup    menu with several more operations you can
  140.        apply to    folders.  Some of these    buttons     will  be  intro
  141.        duced  in  this    man page.  All of these    buttons    and menus
  142.        are explained in    detail in the eexxmmhh--rreeff man page.
  143.  
  144.        To the left of the  folder  buttons,  summary  information
  145.        about the current folder    is displayed.
  146.  
  147.        TTaabbllee  ooff  CCoonntteennttss.   The middle subwindow of the display
  148.        shows a summary of the messages in the folder.    It  shows
  149.        the message number, the date of the mesage, the subject of
  150.        the message, and, space permitting, the first few words of
  151.        the  message.   Left  click on a    line in    the table of con
  152.        tents to    view the corresponding message.     The mouse  bind
  153.        ings  for  the  table  of  contents  are    described in more
  154.        detail in the eexxmmhh--uussee man page.
  155.  
  156.        MH experts: The display in this window comes from both the
  157.        MH  scan     program or MH inc programs, so    it is affected by
  158.        the form    specification used by these programs.
  159.  
  160.        CCoolloorr aanndd MMoonnoocchhrroommee HHiigghhlliigghhttss.     Both the folder  display
  161.        and  table  of contents windows use highlights to give you
  162.        visual clues about the  state  of  messages  and     folders.
  163.        Your  unread messages are highlighted in    the table of con
  164.        tents and the folders  that  contain  unread  message  are
  165.        highlighted  in    the  folder  display.  Pull down the main
  166.        Help menu and select _C_o_l_o_r _L_e_g_e_n_d to display a key to  the
  167.        highlights  for your display.  The highlighting is covered
  168.        in more detail later in the eexxmmhh--uussee man    page.  The  eexxmmhh--
  169.        ccuussttoomm man page tells how you can control the highlighting
  170.        yourself.
  171.  
  172.        SSttaattuuss LLiinnee.  Just below    the table of contents is the sta
  173.        tus  line.   This  has two parts.  The left part    shows the
  174.        name of the folder and the message number for the  current
  175.        message,    if any.     The right part    gives feedback about what
  176.        _e_x_m_h is doing.  After it    displays a message,  the  Subject
  177.        component is displayed there.
  178.  
  179.        SSuubbwwiinnddooww  RReessiizzee DDiiaammoonndd..  The black diamond to    the right
  180.        of the status line is used  to  change  the  size  of  the
  181.        internal     windows.   Press  the first mouse button on this
  182.        target and a horizontal line appears.  Drag it up and down
  183.        to  adjust  the window sizes.  Try dragging it all the way
  184.        to the top and bottom of    the exmh window    to  see     how  the
  185.        mode changes to adjust different    windows.
  186.  
  187.        MMeessssaaggee    BBuuttttoonnss     The bottom row    of buttons are for opera
  188.        tions that apply    to the current message.     Several of these
  189.        operations will be introduced in    this man page.    The right
  190.        hand button labeled More... brings up a menu with  several
  191.        more advanced message operations.
  192.  
  193.        _H_i_n_t_:  Many  of    these  message    operations  have keyboard
  194.        shortcuts that make it easy to use _e_x_m_h with your hands on
  195.        the  keyboard.    Some  of the short-cuts    are introduced in
  196.        this man    page, and all of them are listed in the     eexxmmhh--uussee
  197.        man page.
  198.  
  199.        MMeessssaaggee    DDiissppllaayy.   The bottom subwindow    displays the cur
  200.        rent message, if    any.  Some of the less    interesting  mail
  201.        headers start out scrolled off the top of this window.
  202.  
  203. SSEENNDDIINNGG    MMAAIILL
  204.        A  good    way  to     test  things out is to    send a message to
  205.        yourself.  Here are the steps you take to do that:
  206.  
  207.        1.  Click the Send button, which    is in the Message buttons
  208.        in the bottom group.  A new window will open that contains
  209.        the template for    your message.  The built-in editor, which
  210.        is  called  _s_e_d_i_t,  will     start out with    the insert cursor
  211.        positioned at the end of     the  first  empty  header  line.
  212.        Enter your user name after the To: header.  If you want to
  213.        send the    message    to more    than one person, use a    comma  to
  214.        separate    the names.
  215.  
  216.        2.   Position  the  insert cursor on the    next header line.
  217.        You can do this a few different ways.  The most direct way
  218.        is  to click the    left mouse button where    you want the cur
  219.        sor to be.  There are keyboard  shortcuts,  too.      If  you
  220.        press  <Tab>  the  editor  will take you    to the end of the
  221.        next header line.  You can also use the arrow keys or some
  222.        emacs-like  bindings to move the    cursor.     <Control-n> goes
  223.        to the next line, <Control-f> moves the cursor  forward    a
  224.        character.   <Control-p>     moves up a line, and <Control-b>
  225.        moves back a character.    The _S_i_m_p_l_e _E_d_i_t    menu entry  shows
  226.        you all the keybindings.
  227.  
  228.        3.  The next header is the Cc: line.  People listed in the
  229.        Cc: line    get a "courtesy" (or "carbon") copy of    the  mes
  230.        sage.   By  convention,    the  message is    primarily for the
  231.        people listed in    the To:    component, and the people in  the
  232.        Cc:  component  are getting the message "for information."
  233.        In this case, you can leave the Cc: component empty.
  234.  
  235.        Move the    insert cursor to the Subject: line  and     enter    a
  236.        Subject.     The people that receive your message will get an
  237.        idea of what the    message    is about  from    the  subject,  so
  238.        take  a moment to think of a good one.  For this    test, you
  239.        can type    something like "exmh test message".
  240.  
  241.        4.  Make    sure the headers are  OK.   In    particular,  make
  242.        sure  there  are     no blank lines    in the headers.     The mail
  243.        system treats a blank line as meaning "end-of-headers", so
  244.        you  don't want to prematurely end the header section.  If
  245.        you have    a blank    line, position the insert  cursor  on  it
  246.        and use Backspace to remove the empty line.
  247.  
  248.        Position    the cursor at the start    of the message body.  You
  249.        can use the mouse for this, or you can press  <Tab>  twice
  250.        quickly and the editor will position the    cursor correctly.
  251.        When using the default MH message templates, this will  be
  252.        right after the line of all dashes.
  253.  
  254.        5.   Type  in  your message.  When you type in a    long mes
  255.        sage, the lines will wrap  automatically     at  word  bound
  256.        aries.    To  get     a  blank  line    for paragraph boundaries,
  257.        press <Return>.     The  built-in    editor    supports  several
  258.        editting     commands  that     are  based  on    the GNU    emacs key
  259.        bindings.  If you select    the _S_i_m_p_l_e _E_d_i_t    menu entry  under
  260.        the  main  Bindings  menu, you will bring up a dialog that
  261.        lets you    view and edit the key bindings.
  262.  
  263.        6.  If you are happy with the  message,    you  send  it  by
  264.        pressing     the  Send  button at the top-right corner of the
  265.        window.    The Send button    will turn grey,     and  the  window
  266.        will disappear once the message has been    sent succesfully.
  267.  
  268.        If you do not want to send the message,    press  the  Abort
  269.        button instead.    If you want to save the    message    draft and
  270.        continue    to work    on it later, press the Save&Quit  button.
  271.        Working on a saved draft    message    is described in    the eexxmmhh--
  272.        uussee man page.
  273.  
  274.        Send yourself a few messages, or    have a friend send you    a
  275.        few  test  messages.   You will use these test messages to
  276.        practice    moving around in a folder and deleting    messages.
  277.        Make  one  of the messages pretty long so you can practice
  278.        scrolling through it.
  279.  
  280.        Finally,    try sending mh-mime-sample@online.ora.com a  mes
  281.        sage.   This  addresses    a program that will return a MIME
  282.        message to you.    Just put this address  in  the    To  field
  283.        with  anything  as  the message body and    subject.  Reading
  284.        this message will be described below.
  285.  
  286. MMOOUUSSIINNGG    AARROOUUNNDD
  287.        The selection is    dragged    out with the left  mouse  button.
  288.        You  can     modify     the  selection     by holding the    Shift key
  289.        while pressing the left button.    A double-click    begins    a
  290.        word-oriented selection,    and a triple-click begins a line-
  291.        oriented    selection.  If you drag    a selection off    the  bot
  292.        tom or top of a window the text will be scrolled    automati
  293.        cally and the selection will be extended.
  294.  
  295.        Paste is    done with the middle mouse button.   _T_h_e  _c_u_r_r_e_n_t
  296.        _i_n_s_e_r_t  _p_o_i_n_t  _i_s _u_s_e_d_, _n_o_t _t_h_e _p_o_i_n_t _a_t    _w_h_i_c_h _y_o_u _m_i_d_d_l_e_-
  297.        _c_l_i_c_k_.  If you drag the middle mouse button, then the win
  298.        dow is scrolled instead as described below.  There is also
  299.        a key-binding for paste,    which is <Control-y>.  Use  <Con
  300.        trol-w> or the <Delete> key to delete the selection.
  301.  
  302.        The  middle mouse button    is used    for "drag-scrolling".  To
  303.        scroll, simply press the    middle mouse button over the text
  304.        and  drag  the  text.   If  you    press  the Shift key, the
  305.        scrolling is faster.  Drag-scrolling  works  in    the  text
  306.        widgets,     for  vertical    scrolling, and the one-line entry
  307.        widgets,    for horizontal scrolling.  The text  widgets  are
  308.        used  to     display the folder contents and the current mes
  309.        sage.  The entry    widgets    are used in  various  dialogs  in
  310.        order  to enter values.    You can    change the scrolling but
  311.        ton to the right    button or to only work with shift-middle.
  312.        Set this    up in the Simple Edit Bindings... dialog.
  313.  
  314.        Buttons and menus are also sensitive to which mouse button
  315.        is pressed.  Only the left button activates a button,  and
  316.        it is the <ButtonRelease> event that is important.  If you
  317.        accidentally move the mouse  off     of  the  button  as  you
  318.        release    it,  nothing will happen.  Don't worry,    the wrong
  319.        button will not be invoked.
  320.  
  321.        Press the left button over a menubutton to   pull  down    a
  322.        menu.   Most of the menus in _e_x_m_h are distinguished with    a
  323.        "..."  in their label, e.g. "More...".  The menu     will  go
  324.        away  when the button is    released.  Release the mouse but
  325.        ton off the menu    if you do not want  to    invoke    any  menu
  326.        item.   (In  some  versions  of Tk, the middle button will
  327.        "tear off" a Tk menu.  This is quite handy if you use  the
  328.        menu  often.   To  get the menu to go away, you must click
  329.        the left    button over the    menubutton.  This  will     reattach
  330.        the  menu  to  the menubutton, and another left click will
  331.        make the    menu go    away.  In the latest versions of Tk,  the
  332.        first  menu entry is a dashed line that invokes this tear-
  333.        off operation.)
  334.  
  335. GGEETTTTIINNGG    NNEEWW MMAAIILL
  336.        By now you should have some new mail waiting.   Press  the
  337.        Inc  button  from the middle set    of buttons that    do Folder
  338.        operations.  This will transfer messages    from your  system
  339.        spool file into your inbox folder.  You will hear an audi
  340.        ble cue if there    was new    mail, and the table  of     contents
  341.        will be updated to reflect the new messages in your inbox.
  342.        New messages will be underlined (on a monochrome     screen),
  343.        or blue (on a color screen), to indicate    that you have not
  344.        read them yet.
  345.  
  346.        To view the new message,    click on its line in the table of
  347.        contents,  or press the Next button in the bottom group of
  348.        buttons.     The message will be displayed in the bottom sub
  349.        window,    and  the  line    in  the    table of contents will be
  350.        highlighted to remind you  which     message  is  being  dis
  351.        played.
  352.  
  353.        To view the next    message, click the Next    button.     The key
  354.        board shortcut for this is the 'n' key.
  355.  
  356.        The view    the previous message, click the    Prev button.  The
  357.        keyboard    shortcut for this is the 'p' key.
  358.  
  359.        SSccrroolllliinngg  tthhrroouugghh mmeessssaaggeess.  If    you get    a message that is
  360.        too long    to fit into the    message    window,    then the  scroll
  361.        bar  will  change its appearance    to indicate how    much text
  362.        is displayed.  The scrollbar is Motif-like.  You    can click
  363.        on  the    arrows    at either end to go up and down    one line.
  364.        If you click above or below the elevator    box you    go up and
  365.        down  one  page.     You can drag the elevator box to scroll,
  366.        too.
  367.  
  368.        You can also scroll text    windows    in _e_x_m_h    by dragging  with
  369.        the middle mouse    button.     Press the middle button over the
  370.        text area, not the scrollbar, and hold it down  while  you
  371.        move  the  mouse    up or down.  If    you hold the shift key at
  372.        the same    time, the scrolling is faster.    This works in the
  373.        folder Table of Contents    window,    too.
  374.  
  375.        _H_i_n_t.   The  space bar is a keyboard short-cut that does    a
  376.        combination of scrolling    and advancing to  the  next  mes
  377.        sage.   If  the message is long,    then space will    scroll by
  378.        one screen.  Once you are at the    end of the message, space
  379.        will  advance  to the next message, just    like the 'n' key.
  380.        You can use the BackSpace key to     scroll     back  through    a
  381.        message.
  382.  
  383. RREEAADDIINNGG    MMIIMMEE MMEESSSSAAGGEESS
  384.        By  now you should have also received the sample    MIME mes
  385.        sage from mh-mime-sample@online.ora.com.     The MIME message
  386.        has  three parts    to it, and these are numbered and labeled
  387.        in the display.    The first part is a multipart/alternative
  388.        content,     which    means  there  are a few    different ways to
  389.        view the    content.  This is indicated by the message  under
  390.        the  heading  11..     that  there are alternative views of the
  391.        following content.  _E_x_m_h    will go    ahead and display what it
  392.        thinks    is   the   best     alternative,  and  you     see  the
  393.        text/enriched content displayed in part 11..22.  If    you  want
  394.        to  see    the  other  alternatives,  then    you can    press the
  395.        right button over section 1 to get a popup menu with  some
  396.        choices.
  397.  
  398.        The  next two parts are an audio    clip and a picture in GIF
  399.        format.    The audio clip is handled directly by  exmh,  and
  400.        it displays two active text buttons labeled "Play attached
  401.        audio" and "Save    audio file".  Click on    either    of  these
  402.        with the    left mouse button.  The    part corresponding to the
  403.        image displays a    message    about what the type is,    and  sug
  404.        gests  that  you    press the right    mouse button to    display    a
  405.        menu.  You can always press the right button to get a MIME
  406.        menu that has type-specific options for parts of    your mes
  407.        sage.  If you press the right button over  part    22..,  then
  408.        the popup menu will offer you these choices:
  409.  
  410.           Decode part as MIME
  411.           Save Hello from the author...
  412.           View using mailcap rule...
  413.           Pass an audio fragment to    metamail...
  414.        The  first item is a checkbox menu item that lets you view
  415.        the raw content if you want to.    The  Save...  menu  entry
  416.        displays    a file selection box so    you can    choose a non-tem
  417.        porary file to store the    content.  This same  function  is
  418.        available  through the text button, but not all MIME parts
  419.        displays    buttons    like this.  The    next two  entries  should
  420.        result in the same thing.  They use the mailcap specifica
  421.        tions to    run another program that  displays  the     content.
  422.        In  the    first case, View using mailcap rule...,    _e_x_m_h runs
  423.        the program directly.  In the other case,  Pass    to  meta
  424.        mail...,    the _m_e_t_a_m_a_i_l program is    run first, and it decodes
  425.        the mailcap file    and runs the  external    program.   Again,
  426.        the  text  button labeled "Play attached    audio" also plays
  427.        the audio.
  428.  
  429. RREEPPLLYYIINNGG TTOO MMAAIILL
  430.        Select one of the messages from    your  friend  that  you'd
  431.        like  to     answer.  Press    the left button    over the Reply...
  432.        menu button.  A menu with a few entries will be displayed.
  433.        Select  the  _R_e_p_l_y  _t_o  _s_e_n_d_e_r  menu entry by dragging the
  434.        mouse down to that entry    and letting up over it.     The menu
  435.        entry has a <Key-r> in it, which    means that you could also
  436.        press the 'r' key to invoke this    function.
  437.  
  438.        This time the built-in editor will open a  window  with    a
  439.        message    that  is  partly  filled in.  All the headers are
  440.        initialized based on the    header components from the origi
  441.        nal message.  The built-in editor will automatically posi
  442.        tion the    cursor at the begining of the message body.   You
  443.        can  enter your reply message like you did with the previ
  444.        ous messages.  You should  also    double-check  the  header
  445.        components.   In    this case, add yourself    to the Cc: compo
  446.        nent so you will    get a copy of the  reply  message.   When
  447.        you  are     done, press the Send button in    the editor window
  448.        to send the message.
  449.  
  450.        There are a number of ways to control the format     of  your
  451.        reply  messages.      The MH _r_e_p_l command has several format
  452.        ting options, and because _e_x_m_h uses _r_e_p_l     to  set  up  the
  453.        reply  message, you can customize your reply format.  _E_x_m_h
  454.        lets you    define several variations on reply and    add  them
  455.        to  the Reply...    menu.  This is described in the    eexxmmhh--ccuuss
  456.        ttoomm man page.
  457.  
  458.        It should not take long for you to get  the  copy  of  the
  459.        reply message.  Wait a minute or    so and press the Inc but
  460.        ton.  The keyboard short-cut for    Inc is the 'i' key.
  461.  
  462. SSEELLEECCTTIINNGG MMEESSSSAAGGEESS
  463.        Before we go on to more things you can do  with    messages,
  464.        we need to talk about selecting multiple    messages at once.
  465.        Several of the message operations in _e_x_m_h can operate on    a
  466.        set  of    messages.   You    can manually select multiple mes
  467.        sages by    using the mouse, or you    can select messages based
  468.        on their    content.
  469.  
  470.        UUssiinngg tthhee MMoouussee.     To select messages with the mouse, press
  471.        the left    button and then    drag out a selection.  This  will
  472.        select  a  contiguous  range of messages.  If the messages
  473.        you want    to select are not so nicely  organized,     you  can
  474.        make  a    disjoint  selection by holding down the    Shift key
  475.        while making your selection.  This adds    new  messages  to
  476.        the  selection.     If  you shift-click on    a message that is
  477.        already selected, then it becomes unselected.  If you need
  478.        to select a lot of messages, simply drag    the mouse off the
  479.        top or bottom of    the window.  It    will be    scrolled automat
  480.        ically and the selection    will be    extended.
  481.  
  482. SSEEAARRCCHHIINNGG
  483.        The Search... menu has several operations for finding mes
  484.        sages and finding text within a message.     There is also    a
  485.        help entry that explains    searching in more detail.
  486.  
  487.        If  you select "Find in message body" or    "Find in table of
  488.        contents" a small search    dialog appears.     Enter the search
  489.        string  and  use    the Next or Prev buttons to find the next
  490.        match.  When you    are searching over the table of    contents,
  491.        you can select All to select all    matching messages.
  492.  
  493.        The  other  way    to  search  a  folder  is  with     "Pick by
  494.        attributes".  The MH pick program is used  to  search  the
  495.        current    folder    for messages that match    mail headers like
  496.        From or Subject.     You can  build     up  boolean  expressions
  497.        among search criteria.  This is a much more general search
  498.        mechanism than the "Find    in table of contents"  operation.
  499.  
  500.        Get  started  in     the  Pick dialog by pressing the "Choose
  501.        pick  attribute"     button.   A  menu  of    attribute   types
  502.        appears,     including  the     Subject, From,    To, and    Cc header
  503.        components.  You    can type a regular expression pattern  in
  504.        these  entries to search    for messages that have a matching
  505.        header component.
  506.  
  507.        The Before and After attributes are dates.  You    can  find
  508.        all  messages  before or    after a    given date by using these
  509.        fields.    You can    specify    dates as mm/dd/yy.   Be     sure  to
  510.        include    the  year.   Dates  can     also  be  keywords  like
  511.        "today",    "yesterday", "tomorrow", and any day of    the  week
  512.        ("Sunday", "Monday", and    so on.)
  513.  
  514.        The  Search  attribute  is used to search for something in
  515.        the body    of  a  message.      This    will  run  little  slower
  516.        because    _p_i_c_k  must read    through    all of your messages, not
  517.        just their headers.
  518.  
  519.        If you select more than one attribute, _p_i_c_k finds messages
  520.        that  match  all    the criteria.  In otherwords, it does the
  521.        logical _a_n_d of the search criteria.  If you want    to search
  522.        for  this _o_r that, then you need    to press the Or    button in
  523.        the dialog.  This adds another set of fields to    the  dia
  524.        log,  and  pick will search for everthing that matches the
  525.        first set _o_r matches the    second set.
  526.  
  527.        The "Add    to Sel"    checkbutton should be set _b_e_f_o_r_e  you  do
  528.        the  search.   This  controls  whether or not the selected
  529.        messages    are added to any existing selection.
  530.  
  531.        Finally,    use the    "Pick" button to do the    search.     Once the
  532.        search  has  completed you can perform a    few operations on
  533.        the selection.  You can    delete    and  refile  messages  as
  534.        described later.     You can also display a    new table of con
  535.        tents that only contains    the selected messages.     Use  the
  536.        "New FTOC" button for this.  You    can also clear the unseen
  537.        state of    the messages with the "Mark Seen" button.
  538.  
  539.        The "Clear" button resets the fields.
  540.  
  541.        The two entries in the  dialog  are  used  to  control  MH
  542.        sequences.  The only sequence exmh really supports well is
  543.        the "unseen" sequence, although you can define  up  to  10
  544.        sequences in each folder.
  545.  
  546.        If you use New FTOC to get a new    scan listing, it would be
  547.        better if it appeared in    a new window,  but  currently  it
  548.        replaces     the  table of contents.  You can move around and
  549.        manipulate messages in this table of  contents.     However,
  550.        if  you    do another pick, it will only find things in this
  551.        limited table of    contents, not the  whole  folder.   (Yes,
  552.        this  is    a bug .)  Use the Rescan Folder    menu entry in the
  553.        folder More... menu to get a complete folder listing.
  554.  
  555. FFOORRWWAARRDDIINNGG MMEESSSSAAGGEESS
  556.        If you want to send someone a copy of a    message     or  mes
  557.        sages  that  you     have  received,  use the Forward message
  558.        operation.  Select the messages as described in the previ
  559.        ous  section, then press    the Forward button.  The keyboard
  560.        short-cut for forward is    the 'f'    key.
  561.  
  562.        The message template will have a    copy of    the selected mes
  563.        sages.    You  fill  in the headers, and you can also add    a
  564.        short message before the    start of the forwarded    messages.
  565.        When you    are done, press    Send to    forward    the messages.
  566.  
  567. DDEELLEETTIINNGG MMEESSSSAAGGEESS
  568.        After you have read a message, you might    want to    remove it
  569.        to keep your mail folders tidy.    _E_x_m_h uses  two    steps  to
  570.        remove  mail.   In  the    first  step you    _m_a_r_k a message as
  571.        being deleted.  In the second step you _c_o_m_m_i_t  the  opera
  572.        tions  on  all  marked messages.     It turns out that delete
  573.        just renames your message files.     They will survive  until
  574.        you  get    another    message    by the same number and remove it,
  575.        too.  In    addition, exmh has  a  "Purge  Folder"    operation
  576.        that  removes  these renamed files if they are more than    a
  577.        week old.
  578.  
  579.        The Delete operation applies to the  current  message,  or
  580.        you  can    also select a range of messages    by dragging out    a
  581.        selection in the    table of contents.  You     can  delete  the
  582.        current    message(s)  by    pressing  the Delete button.  The
  583.        keyboard    short-cut is the 'd' key.  The deleted message(s)
  584.        will  be    highlighted after the delete operation so you can
  585.        easily see the state of    the  message.    On  a  monochrome
  586.        screen,    a  cross hatching will be drawn    through    the table
  587.        of contents line    for the    message.  On a color screen,  the
  588.        table of    contents line will get a dark grey background.
  589.  
  590.        After you mark a    message    for delete, you    are automatically
  591.        advanced    to the next message.  This makes it  easy  to  go
  592.        through your folder and clean it    up.  Click 'd' to delete,
  593.        or click    'n' to leave it    alone.
  594.  
  595.        _H_i_n_t.  If you are really    in a hurry, use    'D'  and  'N'  as
  596.        your  keyboard short-cuts.  This    prevents the next message
  597.        from being displayed, which can be slow for complex multi-
  598.        media messages.
  599.  
  600.        When  you  are ready to commit the pending delete actions,
  601.        press the Commit    button.     The keyboard shortcut for commit
  602.        is <Control-Return>.
  603.  
  604.        If  you decide you do not want to delete    a message you can
  605.        unmark it.  Use the _U_n_m_a_r_k _(_U_n_d_o_) menu entry that is under
  606.        the message More... menu.  The unmark operation applies to
  607.        the current message or messages,    so you have to select the
  608.        messages     to  unmark  first.   The  keyboard short-cut for
  609.        unmark is 'u'.
  610.  
  611.        _H_i_n_t.  The minus, '-', keyboard shortcut    takes you to  the
  612.        previous     message,  even    if it has been marked for delete.
  613.        Ordinarily the Prev operation, and the 'p'  short-cut  for
  614.        it, will    skip over marked messages.
  615.  
  616. LLEEAAVVIINNGG    EEXXMMHH
  617.        Press  the  Quit    button to leave    exmh.  It will take a few
  618.        moments to close    down because it    saves some state informa
  619.        tion before quitting.  The Quit button will grey    out after
  620.        you click it, and you will see a    few status messages as it
  621.        shuts itself down.
  622.  
  623. PPRREEFFEERREENNCCEESS
  624.        Try  out     the Preferences by turning off    the folder cache.
  625.        This just takes up display space    if you    don't  have  many
  626.        folders.      If you have lots of nested folders, though, you
  627.        might even want to make this display bigger!
  628.  
  629.        Click the Preference button, which brings up a dialog that
  630.        has  buttons for    several    of the modules that make up _e_x_m_h.
  631.        Click on    the Folder Cache button    to bring up  the  prefer
  632.        ence  items  that  control the folder cache.  In    this case
  633.        there are just two items: the number of lines of    labels in
  634.        the cache, and the names    of folders that    are always in the
  635.        cache.  Click in    the first field    and  backspace    over  the
  636.        default    value  of  1.    Type  in  0  instead,  and  press
  637.        <Return>.  Voila!  The folder cache disappears.
  638.  
  639.        If you like this    setting, press Save one    the main  Prefer
  640.        ence dialog and your changes will be saved to a file named
  641.        ~/.exmh-defaults.  Press    Reset if you want  to  undo  your
  642.        changes.     You should be a little    careful    here, because you
  643.        are allowed to Dismiss the preference dialog without  sav
  644.        ing.
  645.  
  646.        Another    useful preference item to set is under Background
  647.        Processing.  You    can arrange for    _e_x_m_h to    periodically  run
  648.        _i_n_c  so    your  messages are automatcially transferred into
  649.        your inbox.  The    advantage  of  doing  this  is    that  the
  650.        folder  label  highlighting works best this way.     Unfortu
  651.        nately, _e_x_m_h does not give you any visual clues when  mail
  652.        is only waiting in your system spool file.
  653.  
  654.        More details about the Preferences dialog are given in the
  655.        eexxmmhh--uussee    man page, and an overview of the various  prefer
  656.        ence sections is    given in the eexxmmhh--ccuussttoomm man page..
  657.  
  658. WWHHAATT IISS    MMHH MMAAIILL??
  659.        MH  is  a  collection of    UNIX programs that store, manipu
  660.        late, and display your mail. MH originated from RAND,  and
  661.        it  is now in the public    domain.     Exmh uses these programs
  662.        to do all the hard work,    while it concentrates on the user
  663.        interface.
  664.  
  665.        You  can     use the MH programs to    read your mail.     Run them
  666.        from the    UNIX command line like you would cd, ls,  cc,  or
  667.        make.  They are useful when you are connecting over a slow
  668.        line or cannot run exmh for some    other reason.    For  more
  669.        details,     there    are individual man pages for each MH pro
  670.        gram, plus one overview man page    called MH.   Below  is    a
  671.        short summary of    the main MH programs used by exmh.
  672.  
  673.        folder Query or set the current folder.
  674.  
  675.        inc    Incorporate  mail     from your system spool    file into
  676.           your folders.
  677.  
  678.        scan   Display a    listing    of a mail folder.
  679.  
  680.        show   Display a    mail message.
  681.  
  682.        next   Display the next mail message.  (Exmh doesn't actu
  683.           ally run this.)
  684.  
  685.        prev   Display  the  previous mail message.  (Exmh doesn't
  686.           actually run this.)
  687.  
  688.        rmm    Delete a mail message.
  689.  
  690.        refile Move a message into another mail folder.
  691.  
  692.        repl   Reply to a mail message
  693.  
  694.        forw   Forward one or more mail messages.
  695.  
  696.        comp   Compose a    new mail message.
  697.  
  698.        MH keeps    track of the current folder and    the current  mes
  699.        sage in between uses of these MH    programs.  For example:
  700.  
  701.           %    scan +inbox unseen
  702.           1713  04/14 foote.PARC@xerox.  Have you started blasting cdroms yet?<<Probably.
  703.           1715  04/14 FlashBack Publish  1232: Tactix Introduces Break through in Unix Ad
  704.           1716  04/14 FlashBack Publish  1234: CERT    Advisory - NCSA    HTTP Daemon for    UNIX<
  705.           1717 M04/15 To:welch         PGP test<<-----BEGIN PGP MESSAGE----- Version: 2
  706.           1718 M04/17 flash@flashback.c  mime-flashback-w MIME FlashBack April 13th, 1995
  707.           1719 -04/16 Bill Wohler         Notes for MH Chapters 20-22<<Brent, I have    been
  708.           1720+-04/17 "Allen R. Carl"    Re: Tabs<<Brent, where is this -tabs resource se
  709.           %    show 1717
  710.           (Message 1717 displayed)
  711.           %    next
  712.           (Message 1718 displayed)
  713.           %    rmm
  714.           (Message 1718 deleted)
  715.           %    repl 1717
  716.           (Set up template for reply to message 1717, invoke editor)
  717.  
  718.        Each  user  has    a .mh_profile file that    stores general MH
  719.        settings    as well    as per-command settings.  Each line has    a
  720.        key, and    a value.  For example, your mail directory is set
  721.        with the    Path profile entry:
  722.  
  723.           Path: Mail
  724.  
  725.        If your old mail    system uses that directory already,  just
  726.        edit  your .mh_profile to change    the name used for your MH
  727.        mail folders.
  728.  
  729.  
  730. MMOORREE AABBOOUUTT EEXXMMHH
  731.        This man    page should get    you started with  _e_x_m_h.      If  you
  732.        decide  you  want  to know more about it, here are some of
  733.        the features described in the other _e_x_m_h    man pages.
  734.  
  735.        MMIIMMEE ssuuppppoorrtt.  _E_x_m_h can display MIME (Multipurpose  Inter
  736.        net Mail    Extensions) messages, either directly or with the
  737.        help of the _m_e_t_a_m_a_i_l package.  The  built-in  editor  lets
  738.        you  compose  enriched  text  messages and insert files as
  739.        parts of    a multipart message.
  740.  
  741.        MMaaiill FFoollddeerrss.  You can create other mail    folders     to  hold
  742.        messages    about certain topics or    from certain people.  You
  743.        can create a hierarchical  arrangement  of  folders,  just
  744.        like the    hierarchical directory structure of the    file sys
  745.        tem.  The folder    display    supports  these     _n_e_s_t_e_d     _f_o_l_d_e_r_s,
  746.        and it allows you to nest folders to any    depth.
  747.  
  748.        MMaaiill  FFiilltteerriinngg.      Mail    filtering lets you sort    mail into
  749.        different folders _b_e_f_o_r_e    you read it.  If you get lots  of
  750.        mail,  this  is    a great    way to avoid plowing through junk
  751.        mail just to get     your  important  messages.   The  folder
  752.        labels  are  highlighted     to  indicate  which folders have
  753.        unread mail in them.
  754.  
  755.        FFaacceessaavveerr  bbiittmmaapp  ddiissppllaayy.   If     you  have  a    facesaver
  756.        database     on your system, _e_x_m_h displays the bitmap face of
  757.        the person that sent the    current    message    (or their organi
  758.        zation).
  759.  
  760.        BBaacckkggrroouunndd  pprroocceessssiinngg.    You can    set _e_x_m_h to run    _i_n_c peri
  761.        odically, check for new mesages arriving    asynchronously in
  762.        folders,     run  the MH _m_s_g_c_h_k program, or    count up the mes
  763.        sages in    your mail spool    file.
  764.  
  765.        EEddiittoorr iinntteerrffaaccee.  You can hook _e_x_m_h to your favorite edi
  766.        tor  using  the    eexxmmhh--aassyynncc script.  Or,    Tcl-based editors
  767.        such as _m_x_e_d_i_t can interact with    _e_x_m_h directly.
  768.  
  769.        KKeeyybbiinnddiinngg UUsseerr IInntteerrffaaccee.  You can define new  key  bind
  770.        ings for    Tcl commands that are part of the implementation.
  771.  
  772.        AAlliiaasseess UUsseerr IInntteerrffaaccee.    A browser  for    your  MH  aliases
  773.        lets  you  define new aliases and insert    aliases    into mail
  774.        messages.
  775.  
  776.        PPrreettttyy GGoooodd PPrriivvaaccyy ((PPGGPP)).  If you have PGP, you     can  use
  777.        it  from    _e_x_m_h to    digitally sign,    encrypt, and decrypt mes
  778.        sages.
  779.  
  780.        UUsseerr PPrrooggrraammmmiinngg.  If  the  preference  settings     are  not
  781.        enough  for  you, you can program _e_x_m_h more directly.  You
  782.        can define new buttons and menus    and add    new Tcl     code  to
  783.        its implementation.
  784.  
  785. SSEEEE AALLSSOO
  786.        exmh-use, exmh-ref, exmh-custom,    mh
  787.  
  788. AAUUTTHHOORR
  789.        Brent Welch, <welch@acm.org>
  790.  
  791. TTHHAANNKKSS
  792.        To  Xerox PARC/CSL, for supporting this work initially, to
  793.        Sun Microsystems    Laboratories for continuing the     support,
  794.        and to all the exmh users that contributed ideas    and code.
  795.  
  796.  
  797.  
  798. Exmh 2.0         December 3, 1996         EXMH TOUR(1)
  799.